home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / requester / killreq / killreq.doc < prev    next >
Text File  |  1996-04-07  |  3KB  |  67 lines

  1.  
  2.      KILLREQ(1)            AMIGA Programmer's Manual             KILLREQ(1)
  3.  
  4.  
  5.  
  6.      ›1mNAME 
  7.           ›0mkillreq - disables Intuition's AutoRequest() function 
  8.  
  9.      ›1mSYNOPSIS 
  10.           ›0mkillreq [disable | enable] 
  11.  
  12.      ›1mDESCRIPTION 
  13.           ›0mKillreq  is  a  freely  distributable  utility  which  stops
  14.           Intuition from  displaying  AutoRequesters.    Instead,  any
  15.           program  which  tries  to  display  an AutoRequester will be
  16.           fooled into thinking the user selected  the  CANCEL  option.
  17.           In  particular,  AmigaDOS  requesters will not be displayed.
  18.           These include "Please insert volume xyzzy:", "Disk Full" and
  19.           "Volume xyzzy: has a Read/Write error".  
  20.  
  21.           Similar programs (such as NoReq) already  exist,  but  these
  22.           only  affect  requesters  connected  with  a  particular CLI
  23.           window.  KillReq will disable  requesters  on  a  systemwide
  24.           basis.   This  is  particularly useful if you use your Amiga
  25.           remotely a lot, since some programs (BBS-PC springs to mind)
  26.           can  generate  AutoRequesters  even  when  they  have   been
  27.           disabled.  
  28.  
  29.           Invoking  killreq  with no parameters displays a brief usage
  30.           method.  Otherwise, you should specify either  `disable'  or
  31.           `enable'  (only  the  first  letter  is  actually  checked).
  32.           `disable' will stop Intuition from displaying AutoRequesters
  33.           and `enable'  will  allow  AutoRequesters  to  be  displayed
  34.           again.  
  35.  
  36.  
  37.      ›1mOPERATION 
  38.           ›0mKillreq  tries  to be as friendly to the operating system as
  39.           possible.  It SetFunction()'s the AutoRequest() function  in
  40.           Intuition's  library to point to a stub routine which simply
  41.           returns FALSE. If another  program  tries  to  SetFunction()
  42.           AutoRequest(),   killreq  will  still  allow  itself  to  be
  43.           disabled without pulling the rug out from under  the  second
  44.           program.   It  tries  to  guarantee  that the system is in a
  45.           "safe" state at all times.  
  46.  
  47.           In fact, a program that does basically  the  same  thing  as
  48.           killreq  could be written in around 50 bytes of machine-code
  49.           (or less), but since this is such a  simple  application  of
  50.           SetFunction(),  it  seemed  worth  the  extra  code to do it
  51.           "properly" as an example for more sophisticated usages.  
  52.  
  53.      ›1mAUTHOR 
  54.           ›0mEddy Carroll 
  55.           EMAIL: ecarroll@vax1.tcd.ie 
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.      Copyright Eddy Carroll 1989      -1-
  66.  
  67.